home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / edit / mltmt33b.zip / inimaint.txt < prev    next >
Text File  |  1994-11-09  |  20KB  |  402 lines

  1.                          IniMaint
  2.           Copyright 1992, 1993, 1994 by Carry Associates
  3.  
  4. IniMaint is an OS/2 PM program to display and manage *.INI files and
  5. is distributed by Carry Associates, 990 Ironwood Court, Marco Island,
  6. FL, 33937-4458. Telephone number is 813-642-9126. The application was
  7. written by and is supported by Larry J. Martin. You can obtain
  8. Technical support by calling the number above, by leaving an Email on
  9. Compuserve for 72662,3616 or for the same ID in the OS2AVEND Forum
  10. Section 1.
  11.  
  12. The cost for IniMaint is $29.95 for a single user license and $299.00
  13. for an unlimited corporate license. There is a $7.00 shipping and
  14. handling charge to ship a diskette.  Payment can be made via a check
  15. drawn on a US bank, we will invoice against a corporate purchase
  16. order or we will charge either a Visa or MasterCard credit card.
  17.  
  18. WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
  19.  
  20. IniMaint gives you the ability to make virtually any change you want
  21. to any of the INI files in your OS/2 environment. Making changes to
  22. these files must be done with care because you can do serious and
  23. unpredictable damage to your environment. It is STRONGLY SUGGESTED
  24. that you insure that you have a usable backup of any INI file that
  25. you modify in any way.
  26.  
  27. WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
  28.  
  29. The enclosed is a Version 3.3b of IniMaint and has the following
  30. known problems and/or incomplete features:
  31.  
  32. 1. The Initial Dialog cannot be dismissed using the Enter Key, the
  33. Mouse must be used.
  34.  
  35. 2. If the Groups Dialog is displayed, a new Group is selected and
  36. then OK is selected without actually making any changes to any of the
  37. Groups or the Applications in a Group, then the Last Group Displayed
  38. is not updated and a subsequent use of the Groups Dialog will revert
  39. back to the previous Last Group.
  40.  
  41. 3. There is no Help available for the standard OS/2 New File Dialog.
  42.  
  43.  
  44.                  REPORTED COMMENTS OR PROBLEMS
  45.  
  46. The following items are problems that have been reported, but cannot
  47. be reproduced or comments that I have received from one or more
  48. users. Any assistance on the problems or additions to the comments is
  49. more than welcome.
  50.  
  51. 1. It was pointed out that although the Cursor in the Value MLE can
  52. be an Insert Cursor, there is no way to Insert information. My
  53. response is that the only way to change the length of a Value is by
  54. using the Replace Value Dialog because changing the expected length
  55. of an INI Key Value can cause unusual and unexpected errors. I
  56. further responded that the only way to change the cursor is to
  57. change it System wide, therefore, changing it only when it is in the
  58. MLE is a non trivial problem and I have not attempted to do it even
  59. though it leaves the apparent conflict between the appearance of the
  60. Cursor and the actual effect when a key is depressed.
  61.  
  62.                         INSTALLATION
  63.  
  64. To install the this version you must:
  65.  
  66. 1. Run the Install program that is on the supplied diskette and
  67. follow the instructions in the Readme and as displayed by Install.
  68.  
  69. 2. You may optionally add the entry: SET INIMAINT= to your CONFIG.SYS
  70. file specifying the path and filename of an INI file that you want
  71. IniMaint to use to store it's operational information. If this entry
  72. is not found in the Environment, IniMaint will store it's operational
  73. information in the OS2.INI file.
  74.  
  75.                         OPERATION
  76.  
  77. The application can be run in either of two modes. Normal Mode will simply 
  78. run the application in the normal manner, starting with the INI File that was 
  79. current that last time the Application was shut down. Tools Mode will run a 
  80. specifc function and, once that function is complete, the application will 
  81. automatically exit.
  82.  
  83.                         TOOLS MODE
  84.  
  85. The Install Program created a Tools Folder. This Folder contains an Icon for 
  86. each of the Tools that is appropriate to this application. In order to run a 
  87. specific Tool all you need to do is click on the appropriate Icon. If the 
  88. Tool starts with a Menu, for example Copy, you will see the Menu appear on 
  89. the Desktop and the Tool will execute once a Selection is made. If the Tool 
  90. involves a Dialog, for example Repair INI File, the Dialog will appear on 
  91. the Desktop and the Tool will terminate as soon as the Dialog is dismissed. 
  92. If the Tool simply does some function, for example Backup the Desktop, then 
  93. the function will run and then terminate.
  94.  
  95. The purpose of the Tools is to make it much easier for the user to use the 
  96. various features of the application without having to navigate through all of 
  97. the Menus. There is no difference between running a feature via the Tools and 
  98. selecting it from the Menu while running in Normal Mode. The Tools run the 
  99. exact same EXE file as the Normal Mode does, the only difference is that the 
  100. Tools pass a parameter to the EXE file telling to to run in Tools Mode and 
  101. which Tool to run.
  102.  
  103.                        NORMAL MODE
  104.  
  105. To run IniMaint simply start it by clicking on the IniMaint.EXE file
  106. or start it from the Group to which it has been added. When IniMaint
  107. first comes up, it will default to editing the INI file that is
  108. identified by the system as the user INI file. This is normally
  109. C:\OS2\OS2.INI. The name of the current file is always displayed in
  110. the TITLE bar of the main window.
  111.  
  112. IniMaint can also be started with an initial INI file specified on
  113. the command line. This allows IniMaint to be started with a new file
  114. by using the command line, but also allows for it to be started by
  115. dropping a file on the ICON on the desktop or double clicking on an
  116. INI file, once the association is set up.
  117.  
  118. IniMaint will locate the window in a default location, but you can
  119. move and or size the window as you choose. When IniMaint is shut
  120. down, it will remember the file that it was currently working with as
  121. well as the size and location of the window and will restore all of
  122. these the next time it is run.
  123.  
  124. There are a number of IniMaint functions which will take some time
  125. to execute. For example, the maximum length Key Value that IniMaint
  126. will load into the Key Value Window is 60,000 bytes. Since each line
  127. only displays 8 bytes, this comes to 7,500 lines and it takes well
  128. over a minute. There are other similar types of functions, although
  129. the example is the longest. During these long operations, it is not
  130. possible to do any other IniMaint operations. However, the long
  131. functions are done in separate threads and the Message Queue is not
  132. blocked, therefore it is possible to go do some other, non-IniMaint,
  133. function during this time. In addition, since there are a number of
  134. reasons why a user might not want to wait until the lengthy function
  135. is completed, for example, it might have been selected in error,
  136. any IniMaint operation that takes a long time and displays the Wait
  137. Pointer can be terminated by hitting the ESC key.
  138.  
  139. IniMaint will normally store the current operating information such
  140. as the size and position of the windows, that INI file that is
  141. currently being edited and a large number of other items, in the User
  142. INI file, OS2.INI. This is sometimes not a convenient location, since
  143. this file gets completely replaced when a new version is installed
  144. and a problem with the OS2.INI file would mean that IniMaint would
  145. not run. IniMaint will use a different INI file and will create the
  146. file, if necessary, if an Environment Variable INIMAINT= is placed in
  147. the CONFIG.SYS file or in a CMD file that executes IniMaint. For
  148. example, if the user wanted IniMaint to use the file INIMAINT.INI in
  149. the C:\OS2\APPS subdirectory, they would code:
  150.     SET INIMAINT=C:\OS2\APPS\INIMAINT.INI
  151.  
  152.                      GETTING STARTED
  153.  
  154. If you did not obtain your copy of IniMaint to address a specific
  155. problem or you are not familiar with INI files and the kinds of
  156. things that IniMaint allows you to do with them, then it is strongly
  157. suggested that you review the Getting Started entry in the Help file
  158. along with the other General Help subjects.
  159.  
  160.                    MAIN WINDOW DESCRIPTION
  161.  
  162. The Main Window contains three standard child windows. Two of these
  163. windows are Listboxes and the third is a MLE.
  164.  
  165. The upper left Listbox will always contain the list of Applications
  166. for the current INI file.
  167.  
  168. The upper right Listbox will contain the list of Key Names for the
  169. Application that is currently selected in the Application Listbox.
  170.  
  171. The MLE, at the bottom, will contain the hex and ASCII display of the
  172. contents of the Key Name that is selected in the Key Listbox.
  173.  
  174. The Cursor will normally be forced to the MLE and the value of the
  175. data can be modified by changing either the hex or the ASCII fields
  176. of the MLE. The cursor cannot be moved to any portion of the MLE that
  177. does not contain data that can be modified and any modification to
  178. one type of data, hex or ASCII, will immediately be reflected in the
  179. other data.
  180.  
  181. The actual data in the INI file is not changed until the user selects
  182. the Update Item on the Action Menu or selects a different Key or
  183. Application in the same INI file. At this time, you will be asked to
  184. confirm that you want the INI file modified, unless you have turned
  185. the warning option off, see below.
  186.  
  187.                  IniMaint POPUP MENUS
  188.  
  189. In addition to the standard menu entries described below, each window
  190. has a Popup Menu that will appear when the standard action is taken,
  191. clicking once with the Right Mouse Button is the default. Each of the
  192. three primary windows has its own Menu and the Menu will contain those
  193. items which are general to the entire Application and those that
  194. apply to the entries in that particular window. Most of the items on
  195. these menus are discussed below, however, there are three items on
  196. each menu that are unique to the Popup Menus and they are:
  197.  
  198. 1. Explain will attempt to give the user an explanation of the
  199. meaning of the currently selected Application and Key. Not every
  200. Application will have an explanation, but an attempt has been made to
  201. explain all of the standard OS/2 entries as completely as possible.
  202.  
  203. 2. Write Window to a File will cause the entries in the window in
  204. question to be written to a file, so they could be reviewed without
  205. IniMaint running.
  206.  
  207. 3. Print Window will cause the entries in the Window to be printed on
  208. the default printer.
  209.  
  210.                  IniMaint MENU OPTIONS
  211.  
  212. The various IniMaint Menu options are:
  213.  
  214. 1. File gives the user the ability to change INI files, refresh the
  215. current INI file, Dump the contents of the IniMaint variables,
  216. compare two INI files and Exit from IniMaint.
  217.  
  218. The Compare option allows the user to Compare two INI files on any
  219. one of three different levels:
  220.    A. List Applications that are in one INI file, but not the other.
  221.  
  222.    B. A. above plus any Key Names that are in one file, but not the
  223.       other.
  224.  
  225.    C. A. and B. above plus any Key Values that are in both files, but
  226.       are not equal.
  227.  
  228. The differences are displayed in a Listbox within a Dialog that
  229. allows the user to print or write a listing of the Listbox contents
  230. and/or create an INI file with some or all of the Applications or
  231. Keys that have differences.
  232.  
  233. 2. Options will display a Dialog that gives you the ability to:
  234.  
  235.    A. Turn off the display of the opening IniMaint Dialog.
  236.  
  237.    B. Turn off the dialogs that will ask for confirmation before
  238.       Deleting or Modifying the contents of the Current INI file.
  239.  
  240. 3. Groups will display a Dialog that allows you to define and manage
  241. the various Groups for this INI file. A bit of explanation is needed
  242. here. IniMaint gives the user the ability to arrange the applications
  243. in any INI file into Groups. These Groups can then be used in a
  244. number of different IniMaint areas and greatly ease the problems of
  245. handling an INI file with a large number of applications. For
  246. example, the OS2.INI file might be divided into two Groups, System
  247. and Private. The System Group would be the applications put in the
  248. file by OS/2 Install and the Private Group would be the remaining
  249. applications. More or fewer Groups could be defined. How the user can
  250. use Groups within the IniMaint structure will become more clear
  251. below. The Groups Dialog gives the user the ability to define new
  252. Groups, to add and delete Applications and Delete Groups.
  253.  
  254. The procedure for establishing a new Group is to select Groups in the
  255. Group Dialog, select New Group, and supply a name. Once this is done,
  256. the Title of the Dialog will show the current Group and the new Group
  257. will be added to the Group Menu. You add Applications to the Group by
  258. selecting them in the Listbox.
  259.  
  260. The Listbox will display a specific Group or, if you want to know if
  261. there are any Applications that are not in a Group, will display all
  262. Groups. A single Application can be a member of up to 5 different
  263. Groups at any one time, so it is possible to define overlapping
  264. Groups.
  265.  
  266. 4. Size will calculate the minimum amount of Disk Space that would be
  267. required for an INI file that contained a selected set of
  268. Applications in the current INI file. When this item is selected, the
  269. user will be asked what he wants to Size. There will always be
  270. several choices, the various standard INI files, the current file and
  271. the currently selected Application. If there are any Groups defined,
  272. then they will be included among the selections. If there are more
  273. than one Group defined, then there will be an All Groups selection.
  274.  
  275. 5. Actions gives the user the ability to do a number of things:
  276.  
  277.    A. Update Current Key will write any changes that have been made
  278.       to the data in the MLE into the current INI file.
  279.  
  280.    B. Delete Application and Delete Key will do the obvious.
  281.  
  282.    C. Add Application, Add Key and Replace Key Value are all the same
  283.       function except entered at different points. Add Application
  284.       will ask for the name of a new Application to add to the
  285.       current INI file and then fall through to the Add Key, since
  286.       the Applications must have at least one Key. The Add Key will
  287.       ask for the name of the new Key and then fall through to the
  288.       Replace Key Value, since any Key Name must have an associated
  289.       Value. This will cause the Key Dialog box to be displayed. The 
  290.       Application and Key Names will be shown at the top of the
  291.       Dialog, followed by the current length of the data, the ASCII
  292.       representation of the data and the hex representation of the
  293.       data. This is the only option that will change the length of
  294.       a Key Value. Care must be taken when doing this, as many
  295.       applications depend on knowing the length of the INI items. As
  296.       the ASCII or hex values are changed, the changes will appear in
  297.       the other window and the length will be updated. The only
  298.       exception is when only a single hex digit is entered. The ASCII
  299.       window is not updated until two hex characters are entered.
  300.  
  301.    D. Rename and Duplicate Key give the user the ability to change
  302.       the name of an existing Key or to make a duplicate copy of the
  303.       Key using a different Key Name.
  304.  
  305.    E. Copy and Move will ask the user to select a Target File for the
  306.       Copy/Move and will then give the user the same choices as Size
  307.       above. The selected Applications will then be moved or copied
  308.       to the Target INI file, which will be created, if it does not
  309.       exist. This function is done Key by Key, so it will sometimes
  310.       take some time. However, the PM message queue is not blocked
  311.       while the move/copy is being done. The actual move or copy is
  312.       done by a separate program INICOPY, that can also be run as a
  313.       batch program, see below.
  314.  
  315.    F. Backup allows for an easy Backup of the System INI File, User 
  316.       INI File or both the System and User INI Files. Once the user
  317.       has selected names for the normal backups for the two files,
  318.       these files will be presented as the default for additional
  319.       backups. The user can set an Option that will bypass asking
  320.       the user if he wants to use the defaults. This selection will
  321.       always delete the target files before doing the backup, which
  322.       is one of the ways it varies from the Copy selection.
  323.  
  324. 6. Recover contains a list of capabilities designed to give the user
  325. the ability to recover from corrupted INI files. These capabilities
  326. are:
  327.  
  328.    A. Change User and/or System INI Files give the user the ability
  329.       to change the INI files that OS/2 is currently using to new
  330.       files. The primary use of this capability is to allow the user
  331.       to make changes to the User or System INI files that he knows
  332.       need to be made, but cannot make to the current User or System
  333.       Files because of protection built into OS/2. Great care must be
  334.       exercised when doing this, but it will sometimes represent the
  335.       only way that problem entries can be removed from an INI File.
  336.  
  337.    B. Repair inconsistencies between the INI file and the Desktop.
  338.  
  339.    C. Condense the Current INI file, the System INI File, the User
  340.       INI File or both the System and User INI Files. The Condense
  341.       is necessary because of the way updating is done to the INI
  342.       files. The updating will leave empty areas in the INI files and
  343.       these areas tend to get fragmented, thus causing the overall
  344.       size of the INI file to grow, sometimes grow very large.
  345.       Condensing the System or User INI files is not a simple task,
  346.       since they cannot be copied or erased while they are being used
  347.       by OS/2. This item switches the files to the copies long enough
  348.       to erase the old files and copy a condensed backup to the
  349.       original names. The only problem this causes is that it will
  350.       reset the desktop to the boot desktop. This function is removed
  351.       for Version 2.1 of OS/2 and beyond, since the handling of the
  352.       INI files was changed to automatically remove the empty space.
  353.  
  354.    D. There are two items to Test for and Reset the condition where
  355.       the User and System INI files cannot be updated. When this
  356.       condition is found, the user will be asked if he wants to 
  357.       correct the condition and, if he answers yes, the User and
  358.       System INI files will get changed so that they will be able
  359.       to be updated. The process involves making a copy of the INI
  360.       files and switching to them, so it takes a minute or so and
  361.       involves resetting the Desktop.
  362.  
  363. 7. Find allows the user to search the Application Listbox, the Key
  364. Name Listbox, the Key Value MLE, all of the Key Names in the current
  365. INI file, all of the Key Values for the current Application or all of
  366. the Key Values in the current INI file for either an Ascii string or a
  367. Hex value.
  368.  
  369.                              INICOPY
  370.  
  371. INICOPY is the program that is used by IniMaint to do the actual
  372. COPY/MOVE operations. This option is implemented as a separate program
  373. so that the user will have the ability to make copies of INI files,
  374. including the User and System INI files, at any time during the day.
  375.  
  376. The parameters expected by INICOPY are:
  377.  
  378. Required Parameters:
  379.  
  380. -Ifilename  - The fully qualified path and filename of the Source,
  381.               Input, INI file.
  382.  
  383. -Ofilename  - The fully qualified path and filename of the Target,
  384.               Output, INI file. The Target will be created if it does
  385.               not exist.
  386.  
  387. Optional Parameters:
  388.  
  389. -Fx         - Function requested - Default is C(opy)
  390.               C = C(opy)
  391.               M = M(ove)
  392.  
  393. -E          - COPY/MOVE Entire INI file - Default
  394.                                             
  395. -A          - COPY/MOVE All Groups
  396.                                              
  397. -Ggroup     - COPY/MOVE Specific Group
  398.                                              
  399. -Sapp       - COPY/MOVE Specific Application
  400.  
  401. -T          - Use Fast Copy. This is only valid if -E is also specified
  402.